home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Texteditors / ANSIMaster / ANSIMaster.doc < prev    next >
Text File  |  1996-09-26  |  26KB  |  583 lines
  1. ------------------------------------------------------------------------------
  2.                               ANSI Master 1.0
  3.                                     By
  4.                       James Davis and Joe Rattz, Jr.
  5.                     Copyright 1990 by Prism SoftWorks 
  6. ------------------------------------------------------------------------------
  7.  
  8. ANSI Master is released as shareware.  Feel free to distribute the program,
  9. but this doc file must be included.  If you find this program useful,
  10. please send in the $10 U.S. registration fee along with any recommendations
  11. or bug reports to:
  12.  
  13.                 James Davis
  14.                 129 Dixon Avenue
  15.                 Sumter, SC  29153
  16.  
  17.  
  18. DISCLAIMER:
  19.     ANSI Master and this documentation file are provided "as is"
  20. without warranty of any kind.  Further, Prism SoftWorks does not warrant, 
  21. guarantee, or make any representations regarding the use, or the results of 
  22. use, of ANSI Master or this documentation file in terms of correctness or
  23. otherwise.  All risks due to the performance or results of the use of ANSI
  24. Master and this documentation are assumed by you.  
  25.     All references to IBM are referring to IBM compatible computers,
  26. those that use MS-Dos or PC-Dos as their primary operating system, and not
  27. to IBM corporation.  
  28.  
  29.  
  30. Credits:
  31.     ANSI Master is the joint effort of James Davis and Joe Rattz, Jr.
  32. It was designed due to the lack of a good ANSI editor for the Amiga.  Our
  33. definition of good would be based on 4 criteria.  First, and probably most
  34. important, does the ANSI editor use the IBM font, it can't possibly emulate
  35. IBM ANSI correctly if it doesn't.  Second, does it provide the proper number
  36. of possible colors, 16 foreground and 8 background.  Third, does it imbed
  37. the proper ANSI codes into the created ANSI file.  And, fourth, does the
  38. program provide a way to access the line drawing characters that exist in the
  39. IBM font.
  40.     We would also like to thank the many people who have helped us test
  41. our program before distribution.  Thanks to ARP for the arp.library        
  42. requester.  Thanks to HiSoft for HiSoft Basic Professional.  And, finally 
  43. thanks to Commodore for the Amiga, the best personal computer available, it 
  44. can even do a white background!
  45.     Documentation by Joe Rattz, Jr.
  46.  
  47.     If you would like to reach us quickly, or if you want to call
  48. anyway, call:
  49.  
  50.                            The Depot Connection
  51.                               (803) 775-2080
  52.                             300/1200/2400/9600    
  53.                                 Sumter, SC
  54.  
  55.     If you call, you can reach the Amiga section by going into the Main
  56. Menu(M), Bulletin Boards(B), the Computer Users Area(4), Amiga(1).
  57.  
  58.  
  59. ==============================================================================
  60.  
  61.  
  62.                              TABLE OF CONTENTS
  63.  
  64.     1. Installation
  65.        A.  Contents
  66.        B.  Libraries
  67.        C.  Font
  68.     2. Usage
  69.     3. Interface
  70.        A. Keyboard
  71.           1.  Text Keys
  72.           2.  Function Keys
  73.           3.  Other Special Purpose Keys
  74.        B. Gadgets
  75.           1.  System Gadgets
  76.           2.  ASCII Character Gadgets
  77.           3.  Function Gadgets
  78.        C. Menus
  79.           1.  New Document
  80.           2.  Open Document
  81.           3.  Save Document
  82.           4.  Save As...
  83.           5.  Help
  84.           6.  About ANSI Master
  85.           7.  Exit ANSI Master
  86.     4. IBM, AMIGA, and ANSI
  87.     5. Limitations and Our Interpretations of ANSI
  88.     6. Errors
  89.        A.  arp.library missing.
  90.        B.  diskfont.library missing.
  91.        C.  IBM.Font/8 missing.
  92.        D.  Insufficient Memory.
  93.        E.  ANSI Master 1.0 Error (internal)
  94.  
  95.  
  96. ==============================================================================
  97.  
  98.  
  99.  
  100. 1.  Installation:
  101.     ANSI Master requires a few minutes of installation time.  The
  102. installation is very simple, and only requires a couple of files to be
  103. copied.  Please take the time to install ANSI Master properly, as it will
  104. not load without installation.  If you try to load ANSI Master without
  105. first installing it, the program will provide an error message window on
  106. your Workbench screen, telling you what is missing or wrong.  ANSI Master
  107. is shareware, and thus it is not copy protected, so if you run into
  108. trouble, it is not due to copy protection.
  109.   
  110.     A.  Contents:
  111.     ANSI Master is distributed with the following files:
  112.  
  113.         ANSIMaster - the actual program file
  114.         ANSIMaster.info - the icon for ANSI Master
  115.         ANSIMaster.doc - this doc file
  116.         ANSIMaster.doc.info - icon for this doc file
  117.         Example.ANSI - a sample ANSI document
  118.         arp.library - for the requester
  119.         IBM.font - IBM font with line drawing characters
  120.         IBM - subdirectory with the file "8" in it
  121.         8 - IBM font file in the IBM subdirectory
  122.  
  123.     B.  Libraries:
  124.     The following libraries need to be copied to the libs:
  125. subdirectory of your bootdisk:
  126.  
  127.         arp.library
  128.  
  129.     If you are missing the arp.library from the libs: subdirectory
  130. when ANSI Master is loading, you will get an error window on your Workbench
  131. screen.  You MAY also get an error message if you are missing other library
  132. files that are standard on Workbench.
  133.     
  134.     C.  Font:
  135.     ANSI Master requires the IBM font be on the bootdisk in the fonts
  136. subdirectory.  Copy the IBM.font file and the IBM subdirectory into the 
  137. fonts subdirectory.  It is important that you not change the name of the
  138. font or ANSI Master will not find it.  If ANSI Master fails to find this
  139. font on the bootdisk (or any fonts subdirectory overriding it, like
  140. fonts:), it will give an error window on the Workbench screen.   
  141.  
  142.  
  143.  
  144. ------------------------------------------------------------------------------
  145.  
  146.  
  147.  
  148. 2.  Usage:
  149.     ANSI Master was designed for the purpose of creating and editing
  150. ANSI Messages.  If you operate a BBS or use a BBS that supports ANSI codes,
  151. ANSI Master is ideal for creating displays and possibly menus if the
  152. program will allow ANSI menus.  Since, there are a few features we are
  153. using that I have not seen in other programs, I will take the time to
  154. explain them here.
  155.  
  156.     F1:  
  157.     In the bottom right hand corner of the screen, is a sunken box
  158. labeled F1.  In this box you will see whatever ANSI character you last 
  159. selected with the mouse.  Not only will you see the character, you will see 
  160. it displayed in whatever foreground and background color are currently     
  161. selected.  Change the foreground or background color, and the F1 box       
  162. character changes color.  This is displayed here to let you know that it is 
  163. the character you will get if you press the F1 key.  Since we are showing  
  164. color changes in it, you can determine what the character will look like   
  165. when you change the color, without printing the character to the screen.   
  166. When you push the F1 key, this character will be printed to the screen.    
  167. This feature was added to enable the user to make repetitive graphic characters
  168. more easily.  Since gadgets do not auto-repeat, they must be clicked one time
  169. for each character to be printed.  The F1 key allows the user to           
  170. automatically repeat the graphic character by holding it down just like any 
  171. normal text key.  The F1 character displayed in the F1 Box may occasionally 
  172. look irregular with some colors due to some monitor's distortion at this   
  173. extreme corner of the screen.
  174.  
  175.     F2:
  176.     This key copies the line above the current line to the current
  177. line.  This is done for the purpose of making a box.  When you make a box,
  178. all of the lines are alike except for the top and bottom ones.  To simplify
  179. making a box, make the top line, then make the next line, then copy that
  180. line to the next line, repeat this for as many lines as you wish, then do
  181. the bottom line, then you add your text to the box.  Remember, this copies
  182. the line above the current line to the current line, don't accidentally
  183. destroy a line by copying the line above the current line when you meant to
  184. copy the current line to the next lower line.
  185.  
  186.     R:
  187.     At the far right side of the control panel is a sunken area labeled
  188. R:.  This area displays the current row.  
  189.  
  190.     C:
  191.     Below the Row indicator, at the right side, is the Column indicator
  192. sunken and labeled C:.
  193.  
  194.     FG and BG:
  195.     At the far left bottom corner of the control panel is the FG and BG
  196. sunken areas.  These are only labels depicting which row of colors pertain
  197. to the foreground and background.
  198.  
  199.     Example.ANSI:
  200.     We have provided an example document called Example.ANSI.  Try
  201. loading this file into ANSI Master to see the types of files and menus you
  202. can create.  If your BBS program allows you to provide your own ANSI BBS
  203. menus, you can really snazzy-up your BBS with ANSI Master.
  204.  
  205.  
  206.  
  207. ------------------------------------------------------------------------------
  208.  
  209.  
  210.  
  211. 3.  Interface:
  212.  
  213.     3.A.  Keyboard:
  214.  
  215.     1.  Text Keys:
  216.     All of the normal text keys work as you would expect.  Typing from
  217. the keyboard places the characters you type into the document.  Holding
  218. down a key will make that character automatically repeat.  Repeat speed is
  219. determined by preferences.  If your preferences speed is all the way up,
  220. and it is going too slow for you, try lowering the repeat speed in
  221. preferences.  We have found that if this speed is set too high, it will
  222. actually overspeed the program, and slow you down.
  223.  
  224.     2.  Function Keys:
  225.  
  226.     F1:  This key will repeat the last ASCII character gadget selected.
  227. It will automatically repeat like most keys on the keyboard, allowing the
  228. user to make many repetitive characters with just one long keypress.  This is
  229. useful for drawing horizontal lines.  You can determine what character will
  230. print by looking at the F1 box in the bottom right corner of the control
  231. panel.
  232.  
  233.     F2:  This key will copy the row above the current row to the
  234. current row.  This is useful for creating boxes.  Other than the top and
  235. bottom row, the other rows are alike except for text.  To make a box of
  236. several rows tall, make the top line, then the next "middle type" line.
  237. Chances are you will want to duplicate this line to make the box taller.
  238. Go down one row and push F2, and the line you just drew will be copied.  Do
  239. this as many times as you want "middle type" lines, then do the bottom
  240. line, and finally, go back and add text.
  241.  
  242.     F3:  This key will insert a null character in the current cursor
  243. position.  All characters from the cursor position to the right will be
  244. moved one character right.  This will not wrap to the next line, and the
  245. character in column 79 will be erased from the document.  After you have
  246. inserted a null, you will usually want to space over it to fill it in with a
  247. character value and color values.  Again, remember, this is an ANSI graphic
  248. editor, not a text editor, it will not wrap to the next line, and the 
  249. character at position 79 of the current row will be erased.
  250.  
  251.     F4:  This key will duplicate the Page Down gadget, which moves the
  252. document down one page (13 lines) at a time.
  253.  
  254.     F5:  This key duplicates the Page Up gadget and moves the document
  255. up one page at a time.  Notice that the Page Up function key (F5) is above 
  256. the 6 key which has the "^" character pointing up.  This is intentional to 
  257. help the user remember which key (F4 or F5) is Page Up.
  258.  
  259.     F6:  This Key duplicates the Save Document command from the menu.  It
  260. saves to the path and filename if the file has been saved previously.  If the
  261. file has not been saved previously, the ARP file requester will appear.  If
  262. the filename exists in the path already specified, a requester pops up
  263. asking if the user wishes to overwrite the existing file.
  264.  
  265.     F7:  This duplicates the Save As command in the menu.  It will
  266. bring up the ARP file requester and warn if the file is going to overwrite
  267. an existing file.
  268.  
  269.     F8:  This duplicates the Open Document in the menu.  It will bring
  270. up the ARP file requester.  If the current document has been changed since
  271. it was last saved, a requester will appear giving you the chance to abort
  272. the Open and to save the current document.  If you have a current document
  273. and you try to open a new one, the old document will not be cleared until
  274. you have specified a valid file to load.  So, if you accidentally open a
  275. new document, and you unintentionally bypass the FILE NOT SAVED warning,
  276. your file will still be there if you hit cancel on the file requester.
  277.  
  278.     F9:  This brings up the help requester which shows all of the
  279. function keys.  The Help key also does this.  Click the mouse, or hit a key
  280. to close the requester.
  281.  
  282.     F10:  This brings up the about requester and duplicates the About
  283. menu item.  Click the mouse or hit any key to close the requester.
  284.  
  285.     3.  Other Special Purpose Keys:
  286.     Other keys which you may find useful are:
  287.  
  288.         Help - brings up the help window
  289.         Del - deletes the character the cursor is on and moves all
  290. characters on that line to the right of the cursor left one character.
  291. This will not delete characters from the row below, nor will it delete an
  292. entire line if the line is blank.
  293.         Cursor keys - these keys move you through the document just
  294. as you might expect.  When you reach Column 79, your cursor will wrap to
  295. the next line.  Moving left, either with the backspace key or left arrow,
  296. will take your cursor up one row and to Column 79.
  297.         Backspace - puts a null character in the place to the left
  298. of the cursor, then moves the cursor to that position.
  299.  
  300.  
  301.     3.B.  Gadgets:
  302.     The interface control panel consists of three types of gadgets.
  303. All gadgets appear as raised boxes while unselected except for the screen
  304. to back and selected colors gadgets, which appear sunk.
  305.  
  306.     3.B.1  First are the system gadgets.  These are the screen front to
  307. back and back to front gadgets located in the top right corner on the control
  308. panel.  The screen to back gadget is the one on the left and is symbolized by
  309. a sunken square which raises when you click on it.  The screen to front is
  310. symbolized by a raised square which will sink when selected.  The screen to 
  311. back gadget is the only gadget that is sunk in appearance.  All other sunk
  312. displays are only displays for different data.
  313.  
  314.     3.B.2  The second type of gadgets are the ASCII character gadgets
  315. located on the top three rows.  There are 51 of these in three rows of 17
  316. across. They are generally for the purpose of drawing lines and boxes. 
  317. Whenever you select one of these gadgets, the F1 display box, located in the
  318. bottom right corner, displays the character in the currently selected
  319. foreground and background colors.  Pressing F1 will duplicate this character
  320. for you.  This is useful since you must click the gadget every time you want
  321. the character printed, in other words, the ASCII character gadgets will not
  322. repeat merely by holding them down.  By using F1 once you have clicked on
  323. the gadget, you can repeat the character automatically by holding it down
  324. just like any other key.  If you find it too slow, you may have the key
  325. repeat speed set too fast in your preferences.  If the preferences speed is
  326. set too fast, the program will bog down and actually go slower.
  327.  
  328.     3.B.3  The third type of gadgets are function gadgets.  These are
  329. gadgets which will produce a certain function.  The top two on the left edge
  330. are Page Up and Page Down, and are marked with a "P" and an up and down arrow.
  331.     Along the bottom two rows of gadgets are the foreground and background
  332. color selection gadgets.  The foreground colors are on top and there are 16
  333. to choose from.  The background colors are on the bottom and there are 8 to
  334. choose from.  Originally, we had intended to provide 16 background colors,
  335. but since the IBM ANSI standard has no provision for more than 8, there
  336. would be no way to implement them.  Believe it or not, I still have a hard
  337. time with this one, these 8 colors are the only choices IBM users have for
  338. their backgrounds.  I still can't get over the fact that they have no
  339. provision for a white (hi intensity) background.  Of the foreground colors,
  340. the 8 on the left are hi intensity, and the ones on the right are lo
  341. intensity or faint.  If you do not see these same colors when you view a
  342. message created by ANSI Master with a modem program, consult the section in
  343. this doc file called IBM, AMIGA, and ANSI.  The 8 background gadgets are lo
  344. intensity only, as this is all ANSI on the IBM supports.  When you select a
  345. foreground or background color, the change can be detected by either the
  346. fact that the newly selected color is sunk or look in the F1 box on the
  347. bottom right corner of the panel and you should see the last character
  348. selected by gadget, displayed with the new foreground or background color.
  349. You should notice on the bottom left of the color gadgets are the letters FG
  350. and BG.  These sunk areas merely label which row of gadgets is for the
  351. foreground colors and which is for background colors.  
  352.     The two remaining gadgets, one on each side of the color gadgets,
  353. are color swap gadgets.  Originally, when we intended to support 16 colors
  354. for foreground and background, there was only one of these gadgets that
  355. would swap the foreground and background colors.  Well, with the problem of
  356. only 8 background colors, comes another gadget.  The color swap gadget on
  357. the left will swap the foreground color to its root color on the background,
  358. and the background color to the hi intensity of its root color for the
  359. foreground.  The swap gadget on the right will swap the background color to
  360. its lo intensity color for the foreground, and the foreground to the root 
  361. color in the background (huh?).  In other words, the swap gadget on the left
  362. swaps the background colors with the 8 leftmost foreground colors (hi 
  363. intensity), and the right swap gadget switches the background color with the
  364. 8 rightmost foreground colors (lo intensity or faint).
  365.  
  366.     3.C. Menus:
  367.     Project
  368.         New Document
  369.         Open Document
  370.         Save Document
  371.         Save As ...
  372.         Help
  373.         About
  374.         Quit
  375.  
  376.     Under the project menu are 7 choices.  New Document will warn you
  377. if any changes have been made to the current document without saving before
  378. it clears the document.  If this warning requester comes up, either hit the
  379. Yes or No gadget, or hit Y or N on the keyboard. 
  380.  
  381.     Open document will also warn if the current document has been
  382. changed since it was last saved before it clears the current document and
  383. loads one in.  The Open Document menu choice will call up the ARP
  384. requester, thus the ARP Library (Arp.library) is required (see
  385. Installation).  The requester works as usual with the normal gadgets for
  386. parent and selecting files.  The drives gadget will list all mounted drives
  387. and assigned devices, as will clicking the right mouse button.  For more
  388. information on the file requester, consult the ARP documentation file, not
  389. included with this distribution file.
  390.  
  391.     Save Document will save the file directly to the prespecified path
  392. if it has been saved already.  If the file has not been named, the ARP
  393. requester will open, allowing file selection through it.  If a file already 
  394. exists by the name given, a requester will appear requesting whether you   
  395. want to overwrite it.
  396.  
  397.     Save As... brings up the ARP file requester.  If a file already    
  398. exists by the given name, a requester will appear, asking if you wish to   
  399. overwrite the file.
  400.  
  401.     Help will bring up the Help window.  Click the mouse or press any
  402. key to close the window.
  403.  
  404.     About will list the program name, version, release date, authors,
  405. registration fee, and address.  If you like this program, please register,
  406. because the authors plan to use the registration fees to buy a C compiler
  407. to produce some more software, possibly even a C version of this program
  408. with more user definable options.
  409.  
  410.     Quit will exit the program.  If the document has been changed since
  411. it was last saved, a requester will pop up allowing the user to abort the
  412. exit so he can save his file.
  413.  
  414.  
  415.  
  416. ------------------------------------------------------------------------------
  417.  
  418.  
  419.  
  420. 4.  IBM, Amiga, and ANSI
  421.     Supposedly ANSI is a standard, but there are quite a few
  422. differences between the IBM and Amiga implementations.  This program was
  423. designed designed specifically with the IBM implementation in mind.  The
  424. IBM and Amiga ANSI codes we have verified are as follows:
  425.  
  426. IBM                    Amiga
  427. Attributes -                Attributes -
  428. 0 ... Reset colors and attributes    0 ... Reset colors and attributes
  429. 1 ... Hi intensity foreground        1 ... Bold
  430. 2 ... Lo intensity (faint) foreground    
  431.                     3 ... Italics
  432.                     4 ... Underscore
  433.                                         
  434. Foreground colors -            Foreground colors - 
  435. 30 ... Black                 
  436. 31 ... Red
  437. 32 ... Green
  438. 33 ... Yellow
  439. 34 ... Blue
  440. 35 ... Magenta
  441. 36 ... Cyan
  442. 37 ... White
  443.  
  444. Background colors -            Background colors -
  445. 40 ... Black
  446. 41 ... Red
  447. 42 ... Green
  448. 43 ... Yellow
  449. 44 ... Blue
  450. 45 ... Magenta
  451. 46 ... Cyan
  452. 47 ... White
  453.  
  454.     There are no colors listed for the Amiga because nearly all Amiga
  455. programs allow you to change your colors to whatever you want, a luxury
  456. that IBM owners don't get.  With the Amiga, the ANSI codes can generate
  457. whatever the program is setup for.  You may want to try using the type
  458. command on an ANSI file from CLI, you should see color changes and
  459. attributes.  It is also important to know that attributes are cumulative.
  460. Italics and Underscore codes will give you both, to reset, send a 0
  461. attribute.  
  462.  
  463.     It is important to note that the attributes, with the exception of
  464. reverse video, only affect the foreground color.  There are only eight
  465. possible background colors, but due to the attributes hi intensity and lo
  466. intensity, 16 foreground colors.
  467.  
  468.     How you will see messages over the BBS will depend on your terminal
  469. program's interpretation of ANSI.  If your terminal program supports the 
  470. Amiga implementation of ANSI, the main difference you will notice is that 
  471. you will get bold characters instead of hi intensity.  You may still be 
  472. getting hi intensity colors though due to the fact that most Amiga terminal 
  473. programs allow you to set the palette colors to the colors of your choice.  
  474. Due to this, the distinction between hi intensity and lo intensity is 
  475. minimal on the Amiga.
  476.  
  477.  
  478.  
  479. ------------------------------------------------------------------------------
  480.  
  481.  
  482.  
  483. 5.  Limitations and Our Interpretation of ANSI
  484.     ANSI Master requires approximately 400K to run.
  485.     ANSI Master is limited to documents that are 79 columns wide or
  486. less and 50 rows or less.  If you attempt to load a file that has more than
  487. 79 columns, you will get the following message:
  488.  
  489.     FILE TRUNCATED:  Column(s) exceeded 79 characters.
  490.  
  491. If you attempt to load a file with more than 50 rows, not counting leading
  492. blank rows (), you will get the following message:
  493.  
  494.     FILE TRUNCATED:  File exceeded 50 rows.
  495.  
  496. These messages are merely letting you know that the file you loaded was
  497. larger than allowed and will be truncated if you save your document back to
  498. the same filename.  Again, when you get this message, the file has NOT 
  499. actually been truncated, but it WILL be if you save without changing the 
  500. document's filename.
  501.     
  502.     ANSI Master was designed to encompass every useful idea we could
  503. incorporate into the program.  There were certain decisions however that we
  504. had to make regarding what types of files we were expecting to be loading
  505. and what we wanted the output files to look like.  For example, all of our
  506. output files have a first line which is an escape code followed by a left
  507. bracket and 0m ().  We do this to reset any previously set colors or
  508. attributes, thus insuring that the document will display as expected.  This
  509. will also print a blank line when displayed over a BBS program or terminal
  510. program.  Since we were putting a blank line at the top of each file, we
  511. didn't want to have a blank line at the top of the document when you loaded
  512. it back into the editor, so we skip the first line if it is a .  And,
  513. since you are limited to only 50 rows, we decided not to waste precious
  514. rows with leading blank lines, so we decided to skip all leading blank
  515. lines (those with ).  Remember, it is possible to imbed blank lines
  516. merely by putting a space or some other character on that line, thus
  517. preserving any leading blank line you wish.
  518.  
  519.     ANSI Master will work properly with attributes of 0, 1, and 2, but
  520. with other attributes, you may get some unexpected results.  Of course, all
  521. of the color codes are accepted. 
  522.  
  523.  
  524.  
  525. ------------------------------------------------------------------------------
  526.  
  527.  
  528.  
  529. 6.  Errors:
  530.     There are several types of errors you may get while using ANSI
  531. Master.  The first is an installation error.  If you attempt to run ANSI
  532. Master without first installing it, you will probably get an error message.
  533. The different error messages you may get are:
  534.  
  535.     A.  arp.library missing.
  536.     This is caused by arp.library not being in the bootdisk
  537. libs: subdirectory.
  538.  
  539.     B.  diskfont.library missing.
  540.     This is caused by the diskfont.library not being in the bootdisk
  541. libs: subdirectory.
  542.  
  543.     C.  IBM.Font/8 missing.
  544.     This message is caused by either the IBM.font file missing, or the
  545. IBM/8 file missing.  If these files have been copied but renamed, you will
  546. still get this message.
  547.  
  548.     D.  Insufficient Memory.
  549.     This message is caused by not having enough memory available (400K)
  550. to run ANSI Master.  If you do not have enough memory to run ANSI Master,
  551. try unloading another program, or booting without loading Workbench.
  552.  
  553.     E.  ANSI Master 1.0 Error (internal) 
  554.     There are also internal errors you may get while actually running
  555. ANSI Master.  These include:
  556.  
  557.         Out of Memory
  558.         File Not Found
  559.         Device I/O Error
  560.         Disk Full
  561.         Bad File Name
  562.         Device Unavailable
  563.         Disk Write Protected
  564.         Unknown Volume
  565.  
  566.     All of these, except for Out of Memory, are disk related errors and
  567. are fairly easy to understand.  You should not get an Out of Memory error,
  568. because we check to see if there is enough available when the program
  569. starts up, and then we reserve it.  But, since we can't possibly be sure
  570. that you won't find some way to defeat our efforts and make it Guru due to
  571. lack of memory, we check for it anyway, and hopefully make a graceful
  572. exit if the error occurs.  It's not that we think you would intentionally
  573. try to make it Guru or mess it up, we are just new at this and wanted to be
  574. sure.  I hope this program never Gurus due to lack of memory.  In fact we
  575. have done everything we know of (not much) to prevent any Guru from        
  576. happening!
  577.  
  578.  
  579.  
  580. -------------------------------------------------------------------------------
  581.                                     THE END 
  582. -------------------------------------------------------------------------------
  583.